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METHOD AND APPARATUS FOR IMPLEMENTING 
PERSISTENT DATA IN OBJECT ORIENTED PROGRAMS 

FIELD OF THE INVENTION 

5 The present invention generally relates to object oriented programming 

techniques and more particularly to implementing persistent data in an object oriented 
program. 

BACKGROUND OF THE INVENTION 

10 Object persistence is often viewed by software developers as a raw data stream 

containing information from which objects can be instantiated and loaded with state. In 
embedded applications, it is useful to hard-code object persistence. Hard-coded object 
persistence refers to the coding of objects and their state directly into an executable unit. 
Such an object persistence scheme is useful when an application has large amounts of 

15 pre-configured objects, where the performance of object creation and state loading is 
critical. In Visual C++, the optimization required to realize the performance of hard- 
coded objects is not implemented within the compiler. 

Typical object persistence models suffer from a number of performance 
weaknesses. First, the necessity of factory functions generally dictates the use of 

20 dynamic allocation of objects through operator new(). Heap management routines may 
be slow and unreliable. Furthermore, locality of reference issues may result in poor 
performance. Second, objects must assign attribute values read from a persistent data 
stream. Reading data from a data stream not only consumes execution time, but also 
results in excess program code. Finally, pointers to objects that have yet to be created 

25 must be resolved following their creation. 

A method and apparatus that addresses the aforementioned problems, as well as 
other related problems, are therefore desirable. 

SUMMARY OF THE INVENTION 

30 In various embodiments, the invention provides a method and apparatus for 

implementing persistent data in object-oriented programs. In one embodiment, a class 
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declaration is separated into two parts, a first structure type for storage of one or more 
data values, and a class that derives from the structure type. Objects of the structure type 
are instantiated and initialized in the source program. The class definition includes a 
static method that converts an object of the structure type to an instance of the class in 
5 response to a reference to the method. Thereby, memory for the objects is allocated and 
data values are assigned to the objects at compile-time. 

The above summary of the present invention is not intended to describe each 
disclosed embodiment of the present invention. The figures and detailed description that 
follow provide additional example embodiments and aspects of the present invention. 

10 

BRIEF DESCRIPTION OF THE DRAWINGS 

Other aspects and advantages of the invention will become apparent upon review 
of the Detailed Description and upon reference to the drawings in which: 

FIG. 1 is an object model diagram illustrating a relationship between a person and 
1 5 the cars owned by a given person; 

FIG. 2 is a flowchart of a process for persisting data in objects in accordance with 
one embodiment of the invention; 

FIG. 3 has a code segment declares a SPerson structure; 
FIG. 4 has a code segment that declares an example CPerson class; 
20 FIG. 5 has example code segment 106 that assigns data values to an object named 

myData of the SPerson structure type; 

FIG. 6 has program code that implements example traits; 
FIG. 7 has program code that declares an example collection; 
FIG. 8 has program code that implements a trait collection; 
25 FIG. 9A and 9B together include code that implements an example collection 

iterator; 

FIG. 10 includes example code for an initializer called 
CStructCollectionlnitializer; 

FIG. 1 1 has example code that uses pre-processor macros for collection 
30 generation; 
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FIG. 12 includes example code that implements forward referencing for a 
collection; 

FIG. 13 includes example code for referencing an element of one collection in an 
entry of another collection; 
5 FIG. 14 includes example code for defining a collection having no entries; 

FIG. 15A includes an example code segment 125 that implements an aggregate 
that supports vfpointer data members; 

FIG. 15B includes code segment that implements an initialization function for 
SvirtualSupport; 

10 FIG. 15C includes a code segment that illustrates modification of CCarTraits for 

use of the Cinstancelnitializer; and 

FIG. 15D includes a code segment that illustrates usage of CCarTraits ::initializer. 
While the invention is susceptible to various modifications and alternative forms, 
specific embodiments thereof have been shown by way of example in the drawings and 
15 will herein be described in detail. It should be understood, however, that the detailed 

description is not intended to limit the invention to the particular forms disclosed. On the 
contrary, the intention is to cover all modifications, equivalents, and alternatives falling 
within the spirit and scope of the invention as defined by the appended claims. 

20 DETAILED DESCRIPTION 

FIG. 1 is an object model diagram illustrating a relationship between a person and 
the cars owned by a given person. In a typical C++ persistence model, both person 10 
and car 12 would inherit from a persistence class. Both person 10 and car 12 would 
provide specializations of virtual methods inherited from the persistence class that could 
25 save and restore object state (attributes) to and from a persistent data stream. In addition, 
person 10 and car 12 would typically register factory functions with a persistence 
controller object. The persistence controller saves information necessary to instantiate 
the correct type of object upon restoration of a persistent data stream. 

While a typical persistence model provides a convenient method for saving and 
30 restoring object state, it suffers from a number of performance weaknesses. First, the 
necessity of factory functions almost always dictates the use of dynamic allocation of 
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objects through operator new(). Heap management routines may be poor, and locality of 
reference issues may exist. Second, objects must assign attribute values read from the 
persistent stream. This not only takes time, but also results in excess program code. 
Third, pointers to objects that have yet to be created must be resolved following their 
5 creation. 

A typical persistence model does provide flexibility. With such a model, object 
state changes can be written to a persistent stream as required. That is, object state 
changes can be reflected back to the persistence medium. 

Instead of creating objects and saving their state to a persistent stream, consider a 
10 scheme where instantiation of objects is done once when a program starts. Object state 
may be modified or remains constant throughout the lifetime of the program. Such is the 
case in some embedded systems or where large amounts of pre-configured data exist. In 
this case, objects may be instantiated directly within the program. Listing 1 illustrates 
such hard-coded persistence: 

15 
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35 



class CPerson; 

class CCar 
{ 

public: 

CCar( char *make, char *model, CPerson &owner ) : m_make( make ), m_model( 

model ), m_owner( owner ) {} 
CCar( const CCar &from ) : m_make( from.m_make ), m_model( from.rrunodel ), 

m_owner( from.m_owner ) {} 

private: 
char *m_make; 
char *m_model; 
CPerson &m„owner; 

}; 

class CPerson 
{ 

public: 

CPerson( char *name, unsigned long dob ) : m_name( name ), m_dob( dob ) {} 
CPerson( const CPerson &from ) : m_name( from.m_name ), m_dob( from.m_dob ) {} 

private: 
char*m_name; 
unsigned long mjdob; 

}; 

CPerson people[] = { CPerson( "John Smith", 19602302 ), CPerson( "Betty Smith", 
19570503)}; 

CCar cars[] = { CCar( "Ford", "Escort", people[ 0 ] ), CCar( "Honda", "Accord", 
peoplef 1 ] ) }; 



Listing 1 - Example of hard-coded C++ persistence. 



This persistence model makes up for the performance weaknesses of the typical 
C++ persistence model There is no dynamic allocation of objects; all object memory 
allocation occurs at compile time. The programmer also directly controls the locality of 
reference. That is, the programmer can group together commonly referenced data to 
40 make access more efficient. Furthermore, there are no assignments made to object 

attributes read from a persistent stream. All attribute assignments are done at compile 
time. In theory there is no excess program code. Finally, all pointer references are 
resolved at compile time. 
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A limitation of this persistence model is the inability to respond to dynamic object 
state changes. Object state cannot be persisted following change as objects are held in 
transient memory locations. In a number of applications, this is acceptable. This is 
especially true in embedded systems where large amounts of pre-configured data exist. 
5 The following sections describe further use of this hard-coded C++ persistence model. 

The persistence model described above suggests that excess code is eliminated. 
Thus, with an ideal compiler the optimization of the code from Listing 1 would produce 
only data and no machine instructions. However, present compilers of object-oriented 
code, for example, the Microsoft Visual C++ compiler, do generate instructions that 

10 assign attributes to the C++ classes. For large collections of object instances, these 

attribute assignments cause runtime performance problems. In addition, large collections 
of object instances produce excess code. 

The present invention provides a data persistence strategy by which excess code 
can be eliminated and performance enhanced. The following description sets forth 

15 various examples that are specific to Microsoft Visual C++ (versions 5.0 and 6.0). 

However, it will be appreciated that invention may be applied to programs developed for 
other C++ compilers and programs in other object-oriented languages having compilers 
with similar optimization problems. 

FIG. 2 is a flowchart of a process for persisting data in objects in accordance with 

20 one embodiment of the invention. The process generally entails combining known 

programming constructs to persist object-oriented data without producing excess code. 
FIGs. 3-6 set forth specific example code that illustrates usage of the programming 
constructs relative to the invention. Thus, the code in FIGs. 3-6 is referenced and 
described along with FIG. 2. 

25 At step 52, the "structure" construct of C++ is used to declare the desired data 

objects. An example code segment for declaring a structure is set forth below: 

struct 
{ 

int m_a; 

30 int m_b; 

char *m_c; 

} 

myVar = { 3, -7, "Some text" }; 
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The code above creates a variable called "myVar" and initializes the member variables 
with the values 3, -7, and a pointer to the string "Some text". The Visual C++ compiler 
generates only data for the structure initialization given above. Initialization of "plane 
old data structures" (PODS), or aggregates in C++ parlance, provides a building block for 

5 a performance-oriented, hard-coded persistence solution that eliminates excess code. 

The following discussion sets forth a technique for hard-coded persistence of 
simple C++ classes. Simple C++ classes are defined as having no virtual functions 
declared either implicitly through inheritance or explicitly through the class itself. 

FIG. 3 has a code segment that declares a SPerson structure 102. As described 

10 above, an instance of such a structure can be allocated and initialized at compile time 
without the generation of any machine instructions. 

FIG. 4 has a code segment that declares an example CPerson class 104. In this 
simple class, the data members m_name, and m_dob are private and directly accessible to 
any member functions of CPerson. It is possible to generate an instance of CPerson 

15 given an instance of an SPerson. This generation is accomplished through the C++ 
static_cast operation. 

Given an instance of an SPerson structure, a caller can obtain a CPerson instance 
by calling CPerson: :convertTo(). The Microsoft Visual C++ compilers (versions 5.0 and 
6.0) generate no machine instructions when producing a call to CPerson: xonvertToO- 

20 Considering the nature of the staticjcast operation, other C++ compilers may also exhibit 
such behavior. Thus, a CPerson instance can be defined at compile-time where the 
compiler generates no machine instructions for the allocation and initialization of that 
CPerson instance. FIG. 5 has example code segment 106 that assigns data values to an 
object named myData of the SPerson structure type. 

25 From the example code of FIGs. 3-5 it can be seen that achieving efficient hard- 

coded C++ persistence can be accomplished by separating a class declaration into two 
parts. The first part is a structure that represents the data for the class (step 52, FIG. 2). 
Instances of this structure can be separately instantiated and initialized (step 54). The 
second part is declaration of the class itself (step 56). The class must derive from the 

30 structure declaring the data members of the class. The class must not declare any data 
members beyond those declared in the inherited structure. The class must provide a static 
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method by which callers can convert structure references into instances of the class itself. 
In compiling the program code, an instance of such a structure is allocated and initialized 
at compile time without the generation of any machine instructions (step 58). 

It is often necessary for an object instance of one type to reference an object 
5 instance of another type. For example, in Listing 1 an instance of a CCar holds a 
reference to its owner. 

Using the techniques of the previous section, a structure and class declaration can 
be established for a car as follows: 



10 struct SCar 

{ 

char *m_make; 
char *m_model; 
SPerson *m_owner; 

15 }; 

class CCar : private SCar 
{ 

public: 

20 static CCar &convertTo( SCar &f rom ) 

{ 

return static_cast< CCar & >( from ); 

} 

25 CPerson &owner() 

{ 

return CPerson ::convertTo( *m„owner); 

} 

}; 

30 

It will be appreciated that SCar holds a pointer to its owner. Pointers must be 
used because references can't be initialized in a C++ aggregate. Furthermore, the 
member function CCar::owner() returns a reference to its owner by converting m_owner 
to a CPerson reference through CPerson: xonvertToO- A typical usage might be as 
35 follows: 
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{ 

SPerson myData = 

{ 

5 "John Smith", 

19620612 

} 

SCar myCarData = 
10 { 

"Ford", 

"F-150", 

&myData 

} 

15 

CCar &myCar = CCar::convertTo( myCarData ); 
CPerson &me = myCar.owner(); 

20 At this point, a class supporting hard-coded C++ persistence is made of two 

component parts, a structure that describes class data members and the class itself. In 
another embodiment, a third component implements an organizational C++ class. This 
third C++ component, called the traits class, describes a number of fundamental 
characteristics of a class supporting hard-coded C++ persistence. The traits class 

25 provides a practical solution to C++ preprocessor #include problems that arise in the 
application of the hard-coded C++ persistence techniques described herein. The traits 
class also provides a convenient type-navigation ability and concise shorthand notation 
for describing types. 

FIG. 6 has program code that implements example traits 108. The traits class 

30 consists of three public typedefs. The first typedef, "type", names the class being 
described by the particular traits class. The second typedef, "base", names the base 
structure for the class being described by the particular traits class. The third typedef, 
"data", serves several purposes. First, "data" names the structure that will appear in a 
convertTo() operation. Second, the "data" typedef is used by classes that hard-code 

35 references to other classes. Finally, the "data" typedef is used when allocating physical 
data for the class. Note that for simple C++ classes, "base" and "data" refer to the same 
structure. In more complex scenarios, this isn't necessarily the case. 
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Given the declared traits, the SCar aggregate is written to include CPersonTraits. 
In general, all data aggregates must reference other classes through the "data" typedef of 
the referenced class, as demonstrated by the SCar data aggregate. 

The CPerson and CCar classes are also written generically and include the 

5 addition of the typedef, "traits". From an external point of view, any class that is 
required to know the traits class of a particular class can do so by using the "traits" 
typedef. The "traits" typedef enhances type-navigation capabilities. 

Usage of the traits class is described below relative to collections of classes. The 
types described in the traits classes are also expanded below. 

10 The technique of hard-coded C++ persistence is often used to record data for large 

numbers of object instances. Listing 1 shows CPerson objects being collected into an 
array. The use of a collection, such as an array, is an example organizational tool for the 
management of large numbers of object instances. A collection provides a central 
location in which to find object instances. 

15 Instead of using arrays, it is often useful to build collection classes to house object 

instances. Such collection classes can provide methods for searching for particular 
instances. Collection classes can also provide methods that allow iteration over the 
contents of a collection. The population of such collection classes at compile time can be 
especially useful to increase runtime performance. 

20 There are two basic data elements necessary to describe a simple collection class 

that can be populated at compile time. The first data element is the number of instances 
in the collection. The second data element is a pointer to the first data-aggregate instance 
in an array of data-aggregate instances. Using the techniques described above, a simple 
structure-based collection can be declared. FIG. 7 has program code that declares an 

25 example collection 110. 

SStractCollection is a template class that is based on a traits class that describes 
the collection. The data member, m_first, points to the first element in an array of data- 
aggregate instances of type CollectionTraits::collectionData. 

CollectionTraits::collectionData is the type of data being collected. The data member, 
30 m„size 5 describes the number of instances contained in the array to which mjirst points. 



10 



RA-5341 (USYS.023PA) 



Express Mail EL027383635US 



As suggested by the preceding paragraph, the traits class for a collection must 
describe not only the types of the collection itself, but also the type of data being 
collected. Based on the techniques described above, a traits class can be formulated for a 
CStructCollection class inheriting from the previously described aggregate, 
5 SStructCollection, as shown by code segment 1 12 in FIG. 8. 

The traits class can be described in terms of its constituent parts. The 
CStructCollectionTraits, like a traits class for a non-collection class, is templated based 
on the traits class of the type being collected. However, the collection itself, 
CStructCollection and its base aggregate, SStructCollection are templated based on the 
10 collection traits class. The reason for this distinction will become apparent later in this 
description. 

CStructCollectionTraits also introduces an iterator type. This type hides the 
differences associated with traversing different types of collections. For example, some 
collection types may be traversed by simply incrementing a pointer. Other collection 

15 types may require more complex iteration techniques. These iteration differences are 
hidden by the iterator type. 

FIG. 9A and 9B include consecutive code segments 1 14 and 1 16 that implement 
an example collection iterator. The CCollectionlterator is used like any normal C++ 
pointer type. The distinction between CCollectionlterator and a normal C++ pointer type 

20 is that CCollectionlterator holds a TypeTraits: :data pointer that is explicitly converted to 
a TypeTraits: :type pointer or reference on demand. That is, incrementing a 
CCollectionlterator increments a pointer to TypeTraits:: data and not TypeTraits ::type as 
the two types may not be the same size. 

CStructCollectionTraits introduces the concept of an initializer type. One purpose 

25 of the aggregate-based collection is to group together the static data for what are to 
become class instances. Before class instances are allowed to be obtained from the 
collection, it may be necessary to initialize these instances beyond simple data 
initialization. The initializer type describes how to initialize collected class instances. 
In the default case, CStructCollectionTraits establishes 

30 CNullStructCollectionlnitializer as the initializer. CNullStructCollectionlnitializer is 
implemented as follows: 
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template< class TypeTraits > 
class CNullStructCollectionlnitializer 

{ 

public: 

5 typedef TypeTraits: collection collection; 

inline CNullStructCollectionlnitializer( collection::traits::data &collectionData ) 

{ 
} 

10 

inline -CNullStructCollectionlnitializer() 

{ 

} 

}; 



Given a collection of instance data, CNullStractCollectionlnitializer does nothing 
to that data. 

FIG. 10 includes example code for an initializer called 
CStractCollectionlnitializer. Given a collection of instance data, the constructor for 

20 CStructCollectionlnitiaUzer iterates through all data instances invoking the default 

constructor for the class, TypeTraits:: type. The default constructor is invoked through 
the C++ placement new() operator. In addition, when a CStructCollectionlnitializer 
instance is destroyed, CStructCollectionlnitializer iterates through all data instances 
invoking the destructor for the class, TypeTraits ::type. In general, 

25 CStructCollectionlnitializer is useful when instance initialization is required beyond that 
of simply establishing instance data. 
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As an example of populating a CStructCollection, consider establishing a 
collection of SPerson aggregate instances as follows: 
{ 

CPersonTraits::data peopleCollection[] = 
{ 

{"John Smith", 19602302 }, 
{ "Betty Smith", 19570503} 

} 

SStructCol!ection< CStructCollectionTraits< CPersonTraits > >::data people = 
{ 

sizeof( peopleCollection ) / sizeof( SPerson ), 
peopleCollection 

}; 

} 



From the SStructCollection data aggregate and CStructCollectionTraits class, a 
20 CStructCollection class can be defined in a generic fashion (similar to CCar and 
CPerson) as follows: 

tempiate< class CollectionTraits > 

class CStructCollection : private CCollectionTraits::base 

{ 

25 public: 

typedef CollectionTraits traits; 



static traits::type &convertTo( traits::data &from ) 
return static_cast< traits::type & >( from ); 

raits::iterator begin() const 
return mjirst; 

raits::iterator end() const 
return begin () + size(); 

unsigned int size() const 
return m_size; 



}; 
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The CStructCollection class implements methods that return iterators describing 
the beginning and end of the collection. In addition, the CStructCollection class also 
implements a method to obtain the size of the collection. The CStructCollection class 
could be extended to provide other collection capabilities such as searching. 
5 Given the SStructCollection aggregate, people, from the previous example, 

example code to iterate through the collection could be implemented as: 

{ 

CStructCollection< CStructCollectionTraits< CPersonTraits > > &allPeople = 
10 CStructCollection< CStructCollectionTraits< CPersonTraits > >::convertTo( 

people ); 

for ( CStructColIection< CStructColiectionTraits< CPersonTraits > >::iterator i = 
allPeople.begin(); i < allPeople.end(); ++i ) 

15 { 

//do something here 

} 



From the sample code above, it will be appreciated that the template parameters 
make the code quite unwieldy. To express a shorthand representation for the collection 
type a particular type, it is useful to expand the type traits class to describe the collection 
type to use for a particular type. For example, CPersonTraits is declared as: 

25 class CPersonTraits 

{ 

public: 
typedef CPerson type; 
typedef SPerson data; 
30 typedef SPerson base; 

typedef CStructCollection < CStructCollectionTraits< CPersonTraits > > 
collection; 

); 

With the addition of the "collection" typedef, the sample iteration code above becomes 
more concise when coded as: 
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{ 

CPerson::traits::collection &allPeople = CPerson::traits::collection:: 

convertTo( people ); 

5 for ( CPerson::traits::collection::iterator i = allPeople.begin(); i < allPeople.end(); 

{ 

//do something here 

} 

10 

} 



Turning now to another embodiment of the invention, pre-processor macros can 
be used to reduce the amount of code written and enhance readability. Consider again the 
15 following example of describing data for a collection of CPerson instances: 
{ 

CPersonTraits::data peopleCollection[] = 
{ 

20 { "John Smith", 1 9602302 }, 

{ "Betty Smith", 19570503} 

} 

SStructCollection< CStructCollectionTraits< CPersonTraits > >::data people = 
25 { 

sizeof( peopleCollection ) / sizeof( SPerson ), 
peopleCollection 

}; 

30 } 

While this code is straightforward to understand and write, C++ preprocessor 
macros can be used to reduce the amount of code written and make the collections easier 
to read. In addition, the macros can make collection generation foolproof. 
35 FIG. 1 1 has example code 1 18 that uses pre-processor macros for collection 

generation. The macros create two variables that are invisible to a programmer using 
them. The first variable is CollectionName##Collection. This variable contains the 
actual array of instance data. The second invisible variable is 

CollectionName##Initializer. This variable controls the initialization and destruction of 
40 the object instances contained within the collection. Together, COLLECTIONJ3EGIN 
and COLLECTIONJEND allow the expression of the collection, people, in a concise 
way as follows: 
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COLLECTION_BEGIN( CPersonTraits, people ) 

{"John Smith", 19602302 }, 

{ "Betty Smith", 19570503} 
COLLECTION_END( CPersonTraits, people ) 

5 

The representation of a collection and its constituent data can be made even more 
concise with the addition of C++ preprocessor macros that expand 
COLLECTIONJBEGIN and COLLECTION_END for the particular type being 
collected. In addition, the entry of data for the collected type can be made more concise 
10 and foolproof. Consider the following macros that are added to the header file of the 
CPersonTraits class: 

#define PERSON_COLLECTION_BEGIN( CollectionName ) \ 
COLLECTION_BEGIN( CPersonTraits, CollectionName ) 

15 #define PERSON„ENTRY( Name, Dob ) \ 

{ Name, Dob }, 

#define PERSON_COLLECTION_END( CollectionName ) \ 
COLLECTION_END( CPersonTraits, CollectionName ) 

20 

The CPerson collection, people, is now expressed as follows: 

PERSON_COLLECTION_BEGIN( people ) 

P ERS ON_E NTRY( "John Smith", 19602302 ) 
PERSON_ENTRY( "Betty Smith", 19570503 ) 
25 PERSON„COLLECTION_END( people ) 

It will be appreciated that the C++ preprocessor macros remove from the 
programmer the rote coding details of forming a collection. The macros also abstract the 
implementation details from the programmer. In general, the addition of these macros 
30 make coding collections less burdensome. The abstraction provided by these macros also 
eases future maintenance. 

In addition to the CStructCollectionTraits macros described above, several other 
macros are worth considering. The other macros support forward referencing, inter- 
collection referencing, and defining collections with no entries. 
35 FIG. 12 includes example code 120 that implements forward referencing for a 

collection. The forward referencing is implemented using the 
COLLECTION JFORWARD macro. 
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FIG. 13 includes example code 122 for referencing an element of one collection 
in an entry of another collection. The entry referencing is implemented using the 
ENTRYJREF macro. 

FIG. 14 includes example code 124 for defining a collection having no entries. 

5 The empty collection is implemented using the COLLECTION JNTO_ENTRIES macro. 

The preceding description has been directed to simple C++ classes, that is C++ 
classes having no virtual functions. The following description continues with various 
embodiments of the invention relative to complex C++ classes. A complex C++ class 
includes a reference to a virtual function, either implicitly or explicitly. 

1 0 The difficulty in performing hard-coded persistence of complex C++ classes 

arises from the extra data that virtual functions add to class instances. With simple C++ 
classes, the only class data comes from member variables declared in the data aggregates. 
Complex C++ classes add at least one invisible data member to a class. This invisible 
data member is known as the "vfpointer". The "vfpointer" is a pointer to the virtual 

1 5 function table for the particular class instance. 

The Microsoft Visual C++ compiler physically precedes class member variables 
with the "vfpointer". Consider the addition of a virtual function called "displayQ" to the 
CCar class. The addition of this member function to CCar causes a "vfpointer" to be 
allocated before the data member described by the SCar aggregate. 

20 One must consider that references to a CCar object must point at the CCar 

"vfpointer" data member. It is not sufficient to point to the SCar aggregate. This is 
where the distinction between the traits class members "data" and "base" becomes 
important. While CCarTraits::base continues to name SCar, CCarTraits::data must 
somehow account for the "vfpointer" data member. At this point, the introduction of a 

25 new aggregate is in order. This new aggregate will account for "vfpointer" data members 
in classes that have virtual member functions. 

FIG. 15A includes an example code segment 125 that implements an aggregate 
that supports vfpointer data members. The SVirtualSupport aggregate prefixes an input 
aggregate, TypeTraits::base, with an array of "N" void pointers. Classes that use multiple 

30 inheritance may require more than a single "vfpointer". This accounts for having the 
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"vfpointer" array in SVirtualSupport. The mjnitializer member is described below. 

Given SVirtualSupport, CCarTraits can now be written as follows: 

class CCarTraits 
{ 

5 public: 

typed ef CCar type; 

typedef SVirtualSupport< CCarTraits > data; 
typed ef SCar base; 

}; 

10 

It will be appreciated that classes referencing a CCar through CCarTraits:: data 
require no modification. Such is the usefulness of the traits class as an abstraction. As an 
example, consider extending the CPerson class to reference a CCar. SPerson would be 
declared as follows: 

15 struct SPerson 

{ 

char *m_name; 
unsigned long mjdob; 
CCarTraits::data *m_car; 

20 }; 

With the introduction of the "vfpointer" through the SVirtualSupport aggregate, 
there remains one problem to resolve. The problem relates to the initialization of the 
"vfpointer". The "vfpointer" data area cannot be initialized at compile time; it can only 
25 be initialized through the C++ placement new() function. While it would be possible to 
replace the static_cast operation in CPerson: :convertTo() with a placement new call, such 
a replacement would be excessive. That is, the "vfpointer" has to be initialized only 
once. Having the "vfpointer" initialized at every call to CPerson: :convertTo() is 
unnecessary. 

30 A more appropriate solution would be to initialize the "vfpointer" once. To 

accomplish "vfpointer" initialization, SVirtualSupport includes an mjnitializer member 
attribute. The m_jnitializer attribute is a pointer to a function that calls the C++ 
placement new() operator for the particular class type. The parameter to this function is a 
pointer to the location where the C++ placement new() operator will locate the object 

35 instance. 

FIG. 15B includes code segment 126 that implements an initialization function for 
SVirtualSupport. The new class, CInstancelnitializer, is introduced. CInstancelnitializer 
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consists of a single static member function that invokes construction of a particular object 
type at a particular location specified by the "where" parameter. As long as the 
constructor for the particular type does no member initialization, a properly initialized 
object instance will exist at the location specified by the "where" parameter. This 
5 initialization includes the "vfpointer". Given the fact that the initializer invokes the class 
constructor, the initialization sequence provides an opportunity for further programmatic 
object initialization if required. 

The CInstancelnitializer used by a particular type is added to the traits class for all 
types that have virtual methods. FIG. 15C includes code segment 128 that illustrates 
1 0 modification of CCarTraits for use of the CInstancelnitializer. 

FIG. 15D includes code segment 130 that illustrates usage of 
CCarTraits: :initializer. 

As the above example is for illustrative purposes, the previously defined C++ 
collection macros are not used. The above example is also contrived in that a single 
15 object instance is created from static data. Large collections of object instances that can 
be initialized en-mass illustrate the true advantage of static-data object instances. 

It should also be recognized that the initialization of complex C++ classes now 
adds some amount of runtime code to programs utilizing hard-coded persistence. With 
large collections of hard-coded data, the amount of runtime code required to initialize 
20 "vfpointers" is insignificant. Furthermore, there are few performance considerations 
when initializing "vfpointers" as this initialization is typically done only once during 
program startup. 

The idea of "vfpointer" initialization and static-data object instances is of little 
consequence and yields limited usefulness unless a class hierarchy is involved. This 
25 conclusion stems from the overall concept of virtual functions. The following description 
examines considerations for the hard-coded persistence of class hierarchies. 

An example class hierarchy of vehicles is considered. A vehicle is defined to 
have a make, model, and owner. Specific types of vehicles can be cars and boats. Cars 
have mileage and door attributes, while boats have an hours attribute. A vehicle defines a 
30 pure virtual display() function. This function is implemented by the derived classes car 
and boat to display these differing attributes. 
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Based on the discussions of hard-coded persistence so far, consider the 
declaration of a CVehicle class. A CVehicle must derive from an aggregate that 
describes instance data. One consequence of the hard-coded persistence mechanism is 
that the data aggregate must describe the data required for all types in the class hierarchy. 
5 This data must include both persistent and transient data. 

The aggregate describing the instance data for a CVehicle class and its derived 

classes, CCar and CBoat might be implemented as follows: 

struct SVehicleData 
{ 

10 char *m„make; 

char *nrwnodel; 
CPersonTraits::data *m_owner; 
union 
{ 

15 struct 

{ 

int m„miles; 
int m_doors; 

}; 

20 int mjiours; 

}; 

}; 

Notice that SVehicleData includes the data for the cars and boats. This data is 
25 segregated with a union in a way that conserves space as much as possible. 

In this example, SVehicleData happens to include only persistent attributes. 
When any class (base or derived) requires transient instance variables, these must also be 
factored into the data aggregate. The key here is that the data aggregate describes 
member data for object instances. When laying out object instance memory areas, the 
30 hard-coded persistence mechanism relies solely on the data aggregate to describe the 
memory requirements of object instances. 

Besides instance data descriptions, polymorphic classes should also implement 
virtual destructors. This is not a consequence of the hard-coded persistence mechanism, 
but is simply good C++ programming practice. By implementing virtual destructors, the 
35 correct class destructor is guaranteed to be called. 

The following description extends the concepts presented above for hard-coded 
persistence of simple C++ classes to collections of complex C++ classes. Structurally, 
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collections of complex C++ classes are the same as collections of simple C++ classes. 
One difference arises in the area of "vfpointer" initialization. A collection of complex 
C++ instance data easily allows for en-mass "vfpointer" initialization. 

Beyond structure, complex C++ class collections differ from those of simple C++ 
5 classes in that the underlying type of each instance in the collection may be different. 
That is, because simple C++ classes don't implement virtual functions, it does not make 
sense to have collections of heterogeneous object type instances. With complex C++ 
classes, it is often advantageous to have a collection of base-class entities with varying 
derived- type instances. 

10 Consider the case where a collection of vehicles is required. This collection can 

consist of both car and boat instances. This concept is illustrated in the following code 
sequence: 
{ 

15 CVehicle::traits::data vehicieData = 

^ { { 0 M "Ford", "Escort", &personCoilection[ 0 ], { 37653, 2 } }, 
CCarTraits::initializer }, 
{ { 0 }, { "Glasstron", "SSV-17", &personCollection[ 0 ], { 54 } }, 
20 CBoatTraits::initializer }, 

{ { 0 }, { "Honda", "Accord, &personCol!ection[ 0 ], { 54544, 4 } }, 
CCarTraits::initiaiizer}, 

}; 

25 } 

This example illustrates both car and boat data existing in a base-class collection. 
Again, the C++ preprocessor macros have been omitted. The advantage of such a 
collection is that a caller can iterate over the collection calling the virtual methods of the 
30 base class. 

Before such iteration can be done, the "vfpointer" members of each instance must 
be initialized. Because complex C++ classes inherit from the SVirtualSupport aggregate 
and consequently require "vfpointer" initialization, these classes are initialized by a 
special initializer called CVirtualSupportCollectionlnitializer. 
35 CVirtualSupportCollectionlnitializer is defined as follows: 



21 



RA-5341 (USYS.023PA) 



Express Mall EL027383635US 



template< class TypeTraits > 

class CVirtualSupportCollectionlnitializer 

{ 

public: 

5 typedef TypeTraits::collection collection; 

inline CvirtualSupportCollectionlnitializer 

( collection::traits::data &collectionData ) 

10 m_collection( collection: :convertTo( collection Data ) ) 

* for ( collection::traits::iterator i = m_collection.begin(); i < m_collection.end(); 

{ 

15 ( *i.pointer()->m_initializer )( i.pointer() ); 

} 

} 

inline ~CVirtualSupportCollectionlnitializer() 
20 { 

for ( co I lecti on : : traits: : ite rato r i = m_collection.begin(); i < m_collection.end(); 
{ 

typedef collection::traits::collectionType collectionType; 
25 i->collectionType::~collectionType(); 
} 

} 

private: 

30 collection &m_collection; 

}; 

CVirtualSupportCollectionlnitializer differs from CStructCollectionlnitializer in 
how instance initialization occurs. CVirtualSupportCollectionlnitializer iterates through 

35 a collection of instance data, calling the initializer for the specific type described by 
SVirtualSupport::m_initializer. The destructor of CVirtualSupportCollectionlnitializer 
operates in the same manner as the destructor of CStructCollectionlnitializer. 

For collections of complex C++ classes, "vfpointer" initialization is not optional. 
Consequently, a simplified version of CStructCollectionTraits called 

40 CVirtualSupportCollectionTraits is introduced. This traits class describes the various 
types used in collections of complex C++ classes. CVirtualSupportCollectionTraits is 
similar to CStructCollectionTraits, but hard-codes the initializer type instead of making it 
a template parameter. CVirtualSupportCollectionTraits may be defined as follows: 
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template< class TypeTraits > 

class CVirtualSupportCollectionTraits 

{ 

public: 

5 typedef TypeTraits: :data collection Data; 

typedef TypeTraits: :type collectionType; 

typedef CCollection Iterate r< TypeTraits > iterator; 

10 typedef CStructCollection< CVirtualSupportCollectionTraits< TypeTraits > > 

type; 

typedef SStructCollection< CVirtualSupportCollectionTraits< TypeTraits > > 

base; 

typedef SStructCollection< CVirtualSupportCollectionTraits< TypeTraits > > 
15 data; 

typedef CVirtualSupportCollectionlnitializer< TypeTraits > initializer; 

}; 

It should be noted that the differences in the collection traits classes accounts for 

20 the differences in template parameters between collection classes and other classes 

supporting hard-coded persistence. Recall that CStructCollection and its data aggregate, 

SStructCollection is templatedon a collection traits class, while other classes supporting 

hard-coded persistence are templated on their own traits class. 

To illustrate the virtual support and collection techniques, the CVehicle, CBoat, 

25 and CCar collection example is expanded upon below. First, CVehicleTraits is expanded 

to include a description of the collection type for a CVehicle. Furthermore, 

CVehicleTraits is required to define the collection macros. Example code for the 

modifications is as follows: 

class CVehicleTraits 
30 { 

public: 
typedef CVehicle type; 
typedef SVehicleData base; 
typedef SVirtualSupport< CVehicleTraits > data; 
35 typedef CStructCollection< CVirtualSupportCollectionTraits< 

CVehicleTraits > > collection; 

}; 

#define VEHIC LE_COLLECTIONJBEG I N( CollectionName ) \ 
40 COLLECTION_BEGIN( CVehicleTraits, CollectionName ) 

#define VEHICLE_COLLECTION_END( CollectionName ) \ 
COLLECTION_END( CVehicleTraits, CollectionName ) 
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CCarTraits and CBoatTraits, may be defined as: 

class CCarTraits 
{ 

public: 

5 typedef CCar type; 

typedef CVehicleTraits::datadata; 

typedef CVehicle base; 

typedef CVehicleTraits: collection collection; 

typedef Clnstancelnitializer< CCarTraits > initializer; 

10 }; 

#define CARJENTRY( Make, Model, PersonRef, Miles, Doors ) \ 
{ { { 0 }, { Make, Model, PersonRef, { Miles, Doors } } }, 
CCarTraits::initializer::initialize }, 

15 

class CBoatTraits 

{ 

public: 
typedef CBoat type; 
20 typedef CVehicleTraits::data data; 

typedef CVehicle base; 
typedef CVehicleTraits::coliection collection; 
typedef Clnstancelnitializer< CBoatTraits > initializer; 

}; 

25 

#define BOAT_ENTRY( Make, Model, PersonRef, Hours ) \ 
{ { { 0 }, { Make, Model, PersonRef, Hours } }, CBoatTraits::initializer::initialize }, 

It should be noted that both CCarTraits and CBoatTraits define their collection to 
30 be the same as the collection defined by CVehicleTraits. In addition, both CCarTraits 
and CBoatTraits define collection entry macros. The example code below illustrates 
these macros when used together: 
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COLLECTION_FORWARD( CPersonTraits, personsl ) 

VEHICLE_COLLECTION_BEGIN( personl Vehicles ) 
CAR_ENTRY( "Ford", "Probe", ENTRY_REF( personsl, 0 ), 37532, 3 ) 
5 CAR_ENTRY( "Toyota", "Camry", ENTRY_REF( personsl , 0 ), 10032, 4 ) 

BOAT_ENTRY( "Glastron", "SSV-17", ENTRY_REF( personsl, 0 ), 5 ) 
CAR_ENTRY( "Honda", "Accord", ENTRY_REF( personsl, 0 ), 38837, 2 ) 

VEHICLE_COLLECTION_END( personl Vehicles ) 

10 VEHICLE_COLLECTION_BEGIN( person2 Vehicles ) 

CAR_ENTRY( "Ford", "Escort", ENTRY_REF( personsl, 1 ), 37532, 2 ) 
BOAT_ENTRY( "Glastron", "SSV-17", ENTRY_REF( personsl, 1 ), 5 ) 
CAR_ENTRY( "Honda", "Accord", ENTRY_REF( personsl, 1 ), 38837, 4 ) 
VEHICLE_COLLECTION_END( person2Vehicles ) 

15 

PERSON_COLLECTION_BEGIN( personsl ) 

PERSON( "John Smith", 19571129 ) 

PERSON( "Betty Smith", 19601201 ) 
PERSON_COLLECTION_END( personsl ) 

20 

The simplicity of use shown by the code above demonstrates the level of 
abstraction achieved by the present invention. The overall complexity of the hard-coded 
persistence is completely hidden from the programmer's view. Among other aspects, the 
invention provides support classes for creating and initializing large collections of static- 
25 data objects. The use of these support classes and techniques will optimize program 
performance in those programs where hard-coded persistence is appropriate. 
Furthermore, various compilers will generate fewer overall machine instructions for data 
persistence. 

Accordingly, the present invention provides, among other aspects, a method and 
30 apparatus for persisting object oriented data objects. Other aspects and embodiments of 
the present invention will be apparent to those skilled in the art from consideration of the 
specification and practice of the invention disclosed herein. It is intended that the 
specification and illustrated embodiments be considered as examples only, with a true 
scope and spirit of the invention being indicated by the following claims. 
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